package com.ruoyi.system.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.system.domain.SysStudentInteraction;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * 学生课堂互动记录Mapper接口
 *
 * @author ruoyi
 * @date 2025-08-29
 */
public interface SysStudentInteractionMapper extends BaseMapper<SysStudentInteraction>
{
    /**
     * 根据用户ID查询互动记录
     * @param userId 用户ID
     * @return 互动记录列表
     */
    List<SysStudentInteraction> selectByUserId(@Param("userId") Long userId);

    /**
     * 根据用户ID和时间范围查询互动记录
     * @param userId 用户ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 互动记录列表
     */
    List<SysStudentInteraction> selectByUserIdAndTimeRange(
            @Param("userId") Long userId,
            @Param("startTime") Date startTime,
            @Param("endTime") Date endTime);

    /**
     * 根据用户ID和课程ID查询互动记录
     * @param userId 用户ID
     * @param courseId 课程ID
     * @return 互动记录列表
     */
    List<SysStudentInteraction> selectByUserIdAndCourseId(
            @Param("userId") Long userId,
            @Param("courseId") Long courseId);

    /**
     * 统计用户的互动总数
     * @param userId 用户ID
     * @return 互动总数
     */
    Long countTotalByUserId(@Param("userId") Long userId);

    /**
     * 按类型统计用户的互动数量
     * @param userId 用户ID
     * @return 统计结果
     */
    List<Map<String, Object>> countByTypeAndUserId(@Param("userId") Long userId);
}
